home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / am94.zip / AM.DOC < prev    next >
Text File  |  1993-06-07  |  70KB  |  1,704 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                  ArcMaster 9.4
  12.  
  13.                               Copyright 1988-1993
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                  Contents
  34.  
  35.  
  36.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  37.           2  What is ArcMaster?  . . . . . . . . . . . . . . . . . . .  2
  38.           3  Archive Systems Needed to Operate AM  . . . . . . . . . .  2
  39.           4  About Shareware . . . . . . . . . . . . . . . . . . . . .  4
  40.           5  How To Register . . . . . . . . . . . . . . . . . . . . .  5
  41.           6  The New-Ware BBS  . . . . . . . . . . . . . . . . . . . .  6
  42.           7  System Requirements . . . . . . . . . . . . . . . . . . .  7
  43.           8  Version History . . . . . . . . . . . . . . . . . . . . .  7
  44.           9  Distribution Files  . . . . . . . . . . . . . . . . . . .  9
  45.           10  Starting ArcMaster . . . . . . . . . . . . . . . . . . . 10
  46.           11  The User Interface . . . . . . . . . . . . . . . . . . . 10
  47.              11.1  External Files Used by AM . . . . . . . . . . . . . 11
  48.              11.2  Operating from the Main Display . . . . . . . . . . 11
  49.              11.3  On-line Help  . . . . . . . . . . . . . . . . . . . 12
  50.              11.4  Tagging Files . . . . . . . . . . . . . . . . . . . 13
  51.              11.5  Dialog Boxes  . . . . . . . . . . . . . . . . . . . 14
  52.              11.6  The Mouse Interface . . . . . . . . . . . . . . . . 15
  53.              11.7  Positioning Windows/Dialogs . . . . . . . . . . . . 16
  54.           12  Keyboard Commands  . . . . . . . . . . . . . . . . . . . 16
  55.              12.1  Function Keys . . . . . . . . . . . . . . . . . . . 16
  56.              12.2  Alt+Key Commands  . . . . . . . . . . . . . . . . . 16
  57.              12.3  Ctrl+Key Commands . . . . . . . . . . . . . . . . . 17
  58.              12.4  Other Commands  . . . . . . . . . . . . . . . . . . 18
  59.           13  Configuring ArcMaster  . . . . . . . . . . . . . . . . . 18
  60.              13.1  Options . . . . . . . . . . . . . . . . . . . . . . 19
  61.              13.2  Anti-virus Scanner  . . . . . . . . . . . . . . . . 20
  62.              13.3  Start-up Directories  . . . . . . . . . . . . . . . 20
  63.              13.4  The ArcMaster Work Directory  . . . . . . . . . . . 20
  64.              13.5  The Log Directory . . . . . . . . . . . . . . . . . 20
  65.              13.6  The Compression Program Directory . . . . . . . . . 21
  66.              13.7  Password Operations . . . . . . . . . . . . . . . . 22
  67.              13.8  Editor, Browser, and Scan Names . . . . . . . . . . 22
  68.              13.9  Setting Editor Memory . . . . . . . . . . . . . . . 22
  69.           14  Viewing Archive File Contents  . . . . . . . . . . . . . 23
  70.              14.1  Multiple Compressed File Viewers  . . . . . . . . . 23
  71.              14.2  Browsing a Compressed File  . . . . . . . . . . . . 24
  72.              14.3  Editing A Compressed File . . . . . . . . . . . . . 24
  73.              14.4  Creating/Editing a ZIP File Comment . . . . . . . . 24
  74.           15  ARJ Considerations . . . . . . . . . . . . . . . . . . . 24
  75.  
  76.  
  77.  
  78.                                        i
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.           16  PKZIP Considerations . . . . . . . . . . . . . . . . . . 25
  86.              16.1  PKZIP List File Problems  . . . . . . . . . . . . . 25
  87.              16.2  PKZIP Backup Files  . . . . . . . . . . . . . . . . 25
  88.           17  The AM Internal Editor . . . . . . . . . . . . . . . . . 26
  89.           18  AM Use of Expanded/Extended Memory . . . . . . . . . . . 27
  90.           19  Running AM with NDOS or 4DOS . . . . . . . . . . . . . . 27
  91.           20  Search Menu (Alt+S)  . . . . . . . . . . . . . . . . . . 28
  92.           21  Program Menu (Ctrl+X)  . . . . . . . . . . . . . . . . . 28
  93.           22  Registering AM (Alt+R) . . . . . . . . . . . . . . . . . 28
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                        ii
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   1  Disclaimer
  144.  
  145.  
  146.        New-Ware hereby disclaims all warranties relating to this product,
  147.   whether express or implied, including without limitation any implied
  148.   warranties of merchantability or fitness for a particular purpose. New-Ware
  149.   cannot and will not be liable for any special, incidental, consequential,
  150.   indirect or similar damages due to loss of data or any other reason, even if
  151.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  152.   of such damages.  In no event shall the liability for any damages ever
  153.   exceed the price paid for the license to use software, regardless of the
  154.   form and/or extent of the claim.  The user of this program bears all risk as
  155.   to the quality and performance of the software.
  156.  
  157.  
  158.   2  What is ArcMaster?
  159.  
  160.  
  161.        The name ArcMaster is short for the term Archive Master where the word
  162.   archive means a place where documents and/or records are kept.  In the
  163.   modern world of personal computing, these documents and records are
  164.   maintained in computer files.  These files are frequently compressed and
  165.   grouped together in archive files by special computer programs such as
  166.   PKZIP, ARCA, PAK, LHA, and ARJ.  All of these special programs are operated
  167.   from the DOS command line and require the entry of numerous and varied
  168.   command line switches in order to maximize their utility.
  169.  
  170.        ArcMaster, hereafter known as AM for short, is an archive program
  171.   interface control system.  It provides a powerful, easy to use interface
  172.   that removes the burden of remembering all the various command line switches
  173.   and options that may be used with archiving programs.  In addition, AM is a
  174.   flexible DOS shell that provides numerous ways in which the user can
  175.   maintain and manipulate his/her DOS directory and file structures.
  176.  
  177.        AM may be used as a stand-alone program in its useful role as a DOS
  178.   shell, but in order to manipulate compressed archive files the user must
  179.   have present in his/her system at least one of the supported archive
  180.   programs.  A list of supported compression/decompression archive programs
  181.   appears in the next chapter.
  182.  
  183.  
  184.   3  Archive Systems Needed to Operate AM
  185.  
  186.  
  187.        You will need at least one of the following archive systems in order to
  188.   utilize the full capabilities of AM.
  189.  
  190.             ARJ from Robert K. Jung  -  ARJ230.XXX
  191.  
  192.  
  193.  
  194.                                      - 2 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.             Robert Jung
  202.             2606 Village Road West
  203.             Norwood, Massachusetts 02062
  204.  
  205.             LHA from Haruyasu Yoshizaki  -  LHA213.XXX
  206.             This program is free.
  207.  
  208.             PAK from NoGate Consulting  -  PAK251.XXX
  209.             NoGate Consulting
  210.             P.O. Box 88115
  211.             Grand Rapids, MI 49518-0115
  212.  
  213.             ZIP from PKWARE  -  PKZ110.XXX
  214.             PKWARE Inc.
  215.             7545 North Port Washington Road
  216.             Suite 205
  217.             Glendale, WI 53217-3422
  218.  
  219.        The file names following the program identifiers reflect the current
  220.   versions.  Please note the .XXX file extension is given because these will
  221.   vary from location to location.  Many are distributed in compressed
  222.   executable (.EXE) format and some are distributed in the PkWare .ZIP format.
  223.   You can find these marvelous programs on just about any computer bulletin
  224.   board system (BBS) or commercial on-line access system such as Compuserve
  225.   Information Service (CIS) or Genie.  All of these programs may be accessed
  226.   from the New-Ware BBS.  Please see the chapter on the New-Ware BBS in this
  227.   document.
  228.  
  229.        AM supports several utilities designed for the specific purpose of
  230.   compressing executable (EXE) files.  These utilities serve to compress an
  231.   EXE file but allow the compressed file to be executed normally from DOS.
  232.   Their trick is that they insert code into the start of the target EXE file
  233.   that decompresses it as it loads into memory for execution.  AM supports the
  234.   following utilities of that type:
  235.  
  236.                  LZEXE from Fabrice Bellard
  237.                  This program is free
  238.  
  239.                  PKLITE from PkWare
  240.                  PKWARE Inc.
  241.                  7545 N. Port Washington Rd.
  242.                  Suite 205
  243.                  Glendale, WI 53217-3422
  244.  
  245.                  DIET from Teddy Matsumoto
  246.                  This program is free
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                                      - 3 -
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.        While not essential, the user should also have available a file browse
  260.   utility as an alternative to the built in AM browser.  The browser is used
  261.   to view/browse the contents of normal files and compressed files that reside
  262.   inside an archive.  The recommended program is a
  263.   state-of-the-art browser from Vernon Buerg named LIST.COM.  AM can be
  264.   configured to use any file browser that accepts a file path name on its
  265.   command line.  New-Ware feels that LIST is the fastest, most compact, and
  266.   most powerful of the available browsers.  LIST can be found on almost all
  267.   BBSs in the form of LISTxxx.ZIP (or EXE).  Note that the xxx denotes the
  268.   version and version modifier, as in 7.7A (LIST77A.ZIP).
  269.  
  270.        It is important to note the version numbers given above.  AM currently
  271.   supports all version numbers listed above.  Features in earlier versions are
  272.   likely not to be supported and new features in later versions may not be
  273.   supported.
  274.  
  275.        It is strongly recommended that all supported program files reside in a
  276.   directory that is identified in the "CompDir:" field in the AM configuration
  277.   dialog.  If no directory is entered in this field, you will have to ensure
  278.   that ALL supported program files reside on the DOS path.
  279.   If you do not understand the DOS PATH, please read PATHINFO.TXT.
  280.  
  281.  
  282.   4  About Shareware
  283.  
  284.  
  285.        AM is Shareware.  ARJ, PAK, ZIP, and LIST are also Shareware.
  286.   Shareware is NOT free.  It is computer software offered for sale at a set
  287.   price and the only real difference between Shareware and other commercial
  288.   software products is the method of distribution and the important "try
  289.   before you buy" feature.  With Shareware you are normally licensed by the
  290.   owner/author of the program to operate the Shareware distribution copy on a
  291.   trial basis.  Then if you like it and make regular use of it, you are bound
  292.   to pay for it.
  293.  
  294.        Users are licensed to operate ArcMaster on their personal computers for
  295.   the purpose of test and evaluation on a trial basis for a limited trial
  296.   period.  It is not possible to reasonably define any definitive limits of a
  297.   fair and equitable time period for evaluation, therefore it is left to the
  298.   user's judgment and sense of fair play as to the time required to make a
  299.   decision as to its usefulness.  If the user decides the program is not of
  300.   sufficient merit to warrant purchase through registration with New-Ware, the
  301.   program should be removed from his or her personal computer.  Otherwise, if
  302.   the program is deemed useful and is in regular use on the user's personal
  303.   computer system, registration with New-Ware is required.
  304.  
  305.        Registered users are those users that elect to pay for AM and register
  306.   that payment with New-Ware.  By virtue of registration and payment for the
  307.  
  308.  
  309.  
  310.                                      - 4 -
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.   program, registered users are granted a license to continue to utilize the
  318.   program on their personal computer for as long as they choose.  This license
  319.   authorizes the user to use the program on any personal computer system he or
  320.   she may own so long as the program is operated on only one computer system
  321.   at a time.
  322.  
  323.        Site licenses for use of ArcMaster on multiple computers are available
  324.   upon request at a reduced fee that is based on the number of single machines
  325.   licensed for use.
  326.  
  327.  
  328.   5  How To Register
  329.  
  330.  
  331.        There is no functional difference between the Shareware distribution
  332.   version of AM and the registered version save the absence of the opening and
  333.   closing Shareware screens in the registered version.
  334.  
  335.        The price of AM is $35.00.  You may register AM in one of three ways:
  336.  
  337.             1) By mail with check or money order to:
  338.  
  339.                            New-Ware
  340.                            8050 Camino Kiosco
  341.                            San Diego, CA 92122-1820
  342.  
  343.             2) By telephone with Visa/Mastercard to:
  344.  
  345.                            New-Ware
  346.                            (619) 455-6225
  347.                            Business hours ONLY please!
  348.                            Monday thru Friday
  349.                                 8 a.m. to 5 p.m. Pacific Time
  350.                            Saturday
  351.                                 8 a.m. to 1 p.m. Pacific Time
  352.  
  353.             3) Electronically through the New-Ware BBS:
  354.  
  355.                            New-Ware BBS
  356.                            (619) 455-5226
  357.                            24 Hours per day
  358.                            7 Days per week
  359.  
  360.             4) In Japan please call P. & A. Ltd. at 0425-46-9141 to
  361.                Register.
  362.  
  363.        Special site license rates for licensing multiple copies of ArcMaster
  364.   are available.  Please license fee schedule information.
  365.  
  366.  
  367.  
  368.                                      - 5 -
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.        Foreign (non-US/Canada) orders must include a $2.00 special handling
  376.   fee in addition to the $35.00 registration fee.  Also, no checks on banks
  377.   located outside the United States will be accepted.
  378.  
  379.        California residents MUST include state sales tax with their order.
  380.  
  381.        This Shareware version of ArcMaster may be freely copied and passed on
  382.   to other individual users for their evaluation.  Disk vendors and/or
  383.   distributors that desire to distribute ArcMaster must adhere to the
  384.   guidelines presented in VENDOR.DOC.
  385.  
  386.        Press Alt+H and then the "R" key to invoke an interactive registration
  387.   form dialog.  All pertinent information may be entered into the dialog and
  388.   then sent to the printed as a registration form.
  389.  
  390.        Upgrades to later versions are available to registered users on the
  391.   New-Ware BBS at no cost.  Access to the BBS is a privilege granted by New-
  392.   Ware that may be revoked at any time for any reason.  Those who request
  393.   upgrades via telephone or mail must remit a $5.00 charge for an upgrade.
  394.  
  395.  
  396.   6  The New-Ware BBS
  397.  
  398.  
  399.        New-Ware Shareware Products BBS
  400.  
  401.        (619) 450-3257 - Node #1 1200/2400/9600/14400  QuickComm Spirit II
  402.              455-5226 - Node #2 1200/2400 (9600 HST)  US Robotics HST
  403.  
  404.        The New-Ware Shareware Products BSS operates 24 hours per day, 7 days
  405.   per week.  Node #1 is dedicated to registered users only.  Nodes #2 is open
  406.   to all callers.  Users registering via the BBS receive access to the latest
  407.   registered version within 1 day after leaving their credit card data.  Users
  408.   who register by mail or phone may also access the registered version by BBS,
  409.   but you MUST log on and leave a comment to the sysop to the effect that you
  410.   are a registered user and desire access.  The author can also be contacted
  411.   on CIS via PPN 71535,665 (please use EASYPLEX).
  412.  
  413.        The latest versions of all programs that are supported or used by AM
  414.   may be obtained via the BBS.  The BBS also serves as an avenue for product
  415.   support.  You may report problems or ask questions about the operation of AM
  416.   via the message facility of the BBS.
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.                                      - 6 -
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.   7  System Requirements
  434.  
  435.  
  436.        AM may be operated on any IBM PC/XT/AT/PS2 or compatible running under
  437.   DOS 3.0 and above.  The amount of DOS memory required to operate AM will
  438.   vary dynamically and will generally be a function of the number of files in
  439.   each of the main windows.  AM is very efficient and should operate with no
  440.   problems in all but the leanest memory environment.
  441.  
  442.        All monitor and graphics cards are supported, including "composite" (2
  443.   color) monitors and backlit laptop screens.  When executed, AM will
  444.   automatically switch to current screen mode and adjust to the current
  445.   vertical screen height and upon exit to DOS it will restore the original
  446.   video state.  EGA/VGA users may toggle between the normal 25 line and the
  447.   43/50 line mode while running AM and AM may be configured to be forced into
  448.   the 43/50 line mode at run-time.
  449.  
  450.        Mouse support is automatically provided if a mouse driver is present in
  451.   the system.  Any dot matrix or laser printer may be used for printing file
  452.   directory listings.  The printer must be capable of printing IBM line draw
  453.   characters if the directory tree is to be legibly printed.
  454.  
  455.        AM is designed primarily for use with one or more hard drives.
  456.   Starting and operating AM from a 5 1/4" 360K drive is not recommended
  457.   because of the lack of disk space for temporary files, etc.  A multiple 3
  458.   1/2" 720K/1.4M or 5 1/4" 1.2M system will probably be okay, but a hard drive
  459.   is the best way to go.
  460.  
  461.  
  462.   8  Version History
  463.  
  464.  
  465.   Version AMX released for beta test - 03/06/93
  466.  
  467.   Version 9.0 Released - 03/13/93
  468.  
  469.        - Incorporated bug fixes and suggestions from beta testers.
  470.  
  471.   Version 9.1 Released - 03/16/93
  472.  
  473.        - In the AM directory tree the Home and End keys were not sending the
  474.          cursor to the top and bottom of the list.
  475.        - The sort direction (ascending/descending) was not being saved in the
  476.          AM.CFG file.
  477.        - AM was not responding properly to EGA/VGA video modes other than 25,
  478.          43, and 50 line modes.  It now handles 33, 36, etc. modes.
  479.        - AM was not responding the enhanced keyboard auxiliary keypad cursor
  480.          keys.
  481.  
  482.  
  483.  
  484.                                      - 7 -
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.        - Check disk numeric fields were too small for drives of 100 mb or
  492.          larger.
  493.        - Added compressed vs. normal file stats in the compressed file
  494.          viewer.
  495.        - The ability to immediately view a file named on the command line was
  496.          omitted.  Now AM will go to the specified file and invoke the file
  497.          browser if a normal file or the compressed file viewer if a
  498.          compressed file.
  499.        - Dynamic memory indicator (in 1K increments) added to right end of
  500.          menu bar.
  501.        - Added special marker for a Zipped file that PKZIP has marked as a
  502.          text file.
  503.        - Added user-defined color for ZIP and ARJ files in the main, tagged,
  504.          and compressed file list that have hidden, system, etc., file
  505.  
  506.   Version 9.2 Released - 04/15/93
  507.  
  508.        - The active file list was not being updated after deleting converted
  509.          compressed files.
  510.        - The PAK compression dialog file extension field was not being
  511.          properly set.
  512.        - Their were some bugs in the 4DOS DESCRIPT.ION file support functions
  513.          that did not get caught in the beta period.
  514.        - Attempting to SCAN a compressed SFX EXE file would cause a system
  515.          hang.
  516.        - The tag-by-date (Alt+D) function would not work when the "Use global
  517.          tagging" option was turned off.
  518.        - Added volume label switch (-$) to the ARJ compression dialog.
  519.        - Added support for handling CD-ROM drives using the New-Ware tree LOG
  520.          strategy.
  521.        - Smoothed out the action of the cursor bar after certain operations.
  522.        - Added capability to swap tags, i.e., tag all untagged and untag all
  523.          tagged files (Alt+Space).
  524.        - The F8, F9, & F10 key macros for one-key insertion of a compressed
  525.          file name into the compression dialog that existed in v8.4 have
  526.          been restored.  The macros are:
  527.        - Add a "mIsc" menu item that permits clearing the line input editor
  528.          history buffer.
  529.  
  530.   Version 9.3 released 05/14/93
  531.  
  532.        - Fixed problem with passing ARCE.COM an incorrectly formatted command
  533.          line.
  534.        - Fixed bug in maintaining the proper sort direction.
  535.        - Fixed bug in reading ARJ backup files that span a diskette.
  536.        - Added prompt for command line parameter entry when using Ctrl+Enter
  537.          to execute a file.
  538.        - Inserted a user pause between files during batch decompression
  539.  
  540.  
  541.  
  542.                                      - 8 -
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.          operations.
  550.        - Added a mouse press to the user pause function.
  551.        - Added special listing format for the central directory of a floppy
  552.          disk backup set (see section on PKZIP considerations).
  553.        - Added toggle (F2) between file size/length and date/time in the
  554.          compressed file viewer.
  555.        - Added configurable "No archive sort" to the compressed file viewer
  556.          and added ability to toggle (F3) between sort and no sort.
  557.        - Enabled file mask (F7) and sort (F8) commands while in the zoom
  558.          window.
  559.        - Added "/M" command line switch to force into monochome operation.
  560.        - Added ability to show the oldest, newest, smallest, and largest
  561.          files while in the archive file viewer (Alt+S).
  562.        - Added 4 column, 14 horizontally scrolled display of the current
  563.          directory structure (F5 in the graphic tree).
  564.  
  565.   Version 9.4 released 06/08/94
  566.  
  567.        - Fixed problem with deleting file descriptions from 4DOS/NDOS
  568.          DESCRIPT.ION files.
  569.        - Fixed bug in the ZIP comment editor.
  570.        - Add the use of full path names (when applicable) and the "-p"
  571.          switch when processing tags in an ARJ file listing.
  572.  
  573.  
  574.   9  Distribution Files
  575.  
  576.  
  577.        The following files are included in AM distribution package:
  578.  
  579.                  AM.EXE         - Main program
  580.                  AM.OVR         - Overlay file
  581.                  AMHELP.HLP     - Help file
  582.                  AM.DOC         - Operating manual
  583.                  EXECMENU.AM    - Sample program menu
  584.                  AMCOLORS.DOC   - Setting program colors
  585.                  PATHINFO.TXT   - DOS PATH information
  586.                  PROGMENU.DOC   - User defined menu info
  587.                  VENDOR.DOC     - Disk vendor info
  588.                  WHAT'S.NEW     - Latest product info (if needed)
  589.  
  590.        New-Ware prohibits the modification of any of these files in any way,
  591.   shape, or form except by the individual evaluator or purchaser.
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                      - 9 -
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.   10  Starting ArcMaster
  608.  
  609.  
  610.        AM can be started from the DOS command line by typing AM and pressing
  611.   the Enter key.  Up to three command line parameters are accepted.  There may
  612.   be one or two valid DOS path names and there may be one valid DOS file name.
  613.   For example, to start AM with the directory D:\FOO\BAR active in the AM
  614.   right file window, enter AM D:\FOO\BAR.  To start AM with C:\ARCHIVE in the
  615.   left window and D:\FOO\BAR in the right window, enter AM C:\ARCHIVE
  616.   D:\FOO\BAR.
  617.  
  618.        AM may be run from a DOS batch file or from another DOS shell, but if
  619.   it is run from another shell you may have to adjust the configuration so
  620.   that AM has sufficient memory to operate.
  621.  
  622.        If a file name may be placed on the command line when starting AM, the
  623.   file will be viewed as soon as loads the main file windows.  This means that
  624.   the compressed file viewer will be called if the file is a compressed file,
  625.   otherwise the default browser will be called.
  626.  
  627.        First time users of the Shareware evaluation version of AM will note
  628.   that the first event that occurs after the Shareware delay is complete is
  629.   the appearance of the AM configuration dialog.  It is important that you
  630.   configure at the very least the following two directories:
  631.  
  632.                  Work Dir:
  633.                  Comp Dir:
  634.  
  635.        The work directory is require for the exclusive use of AM.  The
  636.   compression directory is the single directory where all of your archive
  637.   system programs, etc. reside.
  638.  
  639.        Be sure to save the configuration to disk before proceeding.
  640.  
  641.  
  642.   11  The User Interface
  643.  
  644.  
  645.        The AM user interface has been carefully designed to provide a set of
  646.   commands and controls that maximize the program's utility for both straight
  647.   keyboard and mouse users.  The interface employs a "point and shoot" file
  648.   manipulation function via file name lists with scrolling cursor bars.  All
  649.   AM functions are available through a pull-down menu system that may be
  650.   activated with the mouse or by pressing either keyboard slash (/ or \) key.
  651.   All functions are also accessible via Alt and Ctrl key combinations.  The
  652.   program can be exited to DOS via the menu, by pressing Esc key, by pressing
  653.   Alt+=, or by pressing Alt+X.  Alt+X exits immediately while the Esc key asks
  654.   for confirmation.
  655.  
  656.  
  657.  
  658.                                      - 10 -
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.        Most commands result in the appearance of a window or dialog box.  For
  666.   the purposes of this manual, dialog boxes are windows that contain
  667.   specialized controls such as check buttons and push buttons.  All windows
  668.   can be exited immediately by pressing the Esc key.  The same effect will
  669.   result from clicking on the small square symbol in the upper left corner of
  670.   the window.
  671.  
  672.   11.1  External Files Used by AM
  673.  
  674.        AM creates and maintains the following program support files:
  675.  
  676.             AM.CFG              The current program configuration file
  677.             AMCOLOR.SET         The current color configuration file
  678.             AM.HST              The current input history file
  679.  
  680.        These files will be created and maintained in the directory in which AM
  681.   is operated from.  AM.HST is always created and is updated at the
  682.   termination of each AM session.  AMX.CFG and AMCOLOR.SET will only be
  683.   created when specified by the user.
  684.  
  685.   11.2  Operating from the Main Display
  686.  
  687.        AM has two main file list windows.  Each window is capable of
  688.   displaying all the files from a specific DOS directory from any drive in
  689.   your system.  Only one window can be active at a time and the active window
  690.   displays a different frame and file selection indicator from that of the
  691.   inactive window.
  692.  
  693.        The user may change the active window by pressing the Tab key, the
  694.   Right/Left Arrow keys, or by clicking in the desired window's area with the
  695.   mouse.  The cursor pad keys (Home, PgDn, Up Arrow, etc.) always move the
  696.   cursor bar in the active window up or down the file list.
  697.  
  698.        The file list in each window consists of a text line that represents
  699.   each file retrieved from the active directory.  This line displays the file
  700.   name, size in bytes, and the date.  The line just above the file list frame
  701.   contains the sequential number and name of the file under the cursor bar as
  702.   well as the file time and the file attribute codes.
  703.  
  704.        AM supports a character-by-character file name speed search.  The
  705.   search string is built by pressing character keys and it appears just above
  706.   the list frame during the search.  As the string is built, AM will search
  707.   the list for the first file name that matches and move the cursor bar to
  708.   that file line if found.  For example, if "Q" is pressed and then "Z" is
  709.   pressed and there is at least one file name on the list that begins with
  710.   "QZ", AM will move the cursor to that file.  Moving the cursor bar with any
  711.   arrow key will halt the search and the Backspace key may be used to remove
  712.   characters from the search string.
  713.  
  714.  
  715.  
  716.                                      - 11 -
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.        Most AM commands act either directly upon the file under the cursor bar
  724.   when the command is activated or upon a group of files that have been tagged
  725.   (marked) for batch operation.  More about tagging files can be found later
  726.   in this document.  The symbol that indicates that a file is tagged is a
  727.   small right triangle located to the left of the file name.
  728.  
  729.        The top bar of the display is a menu bar that may be accessed by
  730.   clicking on an item with the mouse, pressing Alt+"key" where k is one of the
  731.   menu item shortcut keys (A, F, N, I, P, H & G), or by pressing the "/" or
  732.   "\" key.  All AM functions can be activated through one of the main menu
  733.   items.
  734.  
  735.        A two-line status bar occupies the bottom two lines of the display.
  736.   The first line indicates certain commands and the related command keys and
  737.   the second line contains the current time, date, and hot archive name.  The
  738.   first line of the status bar will change to support various pop-up windows
  739.   and dialogs.
  740.  
  741.        AM supports multiple editing windows and multiple archive file viewer
  742.   windows.  The two main windows and all multiple edit and viewer windows are
  743.   numbered in the upper right hand frame corner.  The left and right main
  744.   windows are numbered #1 and #2, respectively.  Non-mouse users may move from
  745.   window to window by pressing Alt+# where # is the number of the window to
  746.   make active.
  747.  
  748.   11.3  On-line Help
  749.  
  750.        Textual descriptions of all AM functions are available from the main AM
  751.   display and all windows by pressing the F1 key, using the main Help menu, or
  752.   by clicking on the Help identifier in the status bar.  A window will open
  753.   that either presents a list of commands and abbreviated command names or
  754.   context sensitive help.  Selecting an item from the help list will open
  755.   another window that contains a description of the selected command.
  756.  
  757.        Help for a specific item can be located by accessing the main menu,
  758.   placing the cursor bar over the desired item, and pressing the F1 key or
  759.   clicking with the mouse on the status bar help identifier.
  760.  
  761.        The help system is cross-referenced and cross-referenced items appear
  762.   in highlight in the help text window.  Use the Tab key to move through
  763.   available cross-reference items and press the Enter key (or double click the
  764.   mouse) on the desired item to change the help window to text on that
  765.   specific item.
  766.  
  767.        Press the F1 key while in the help system to access an alphabetized
  768.   menu of AM functions for which textual help is available.
  769.  
  770.  
  771.  
  772.  
  773.  
  774.                                      - 12 -
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.        You may send any help topic that is loaded into the help window to your
  782.   printer by pressing Alt+P.
  783.  
  784.        Press Alt+F1 to return to the last help topic viewed.
  785.  
  786.        AM provides the capability to use the designated file browser (usually
  787.   LIST.COM) to browse the associated archive system documentation (DOC) file
  788.   from the compression and decompression dialog boxes via Alt+F1.  The
  789.   associated DOC file(s) must be named as specified below and must reside in
  790.   the same directory that is identified in the "CompDir:" field of the AM
  791.   configuration dialog.  This is the same directory AM expects to find all
  792.   supported archive system files.
  793.  
  794.                            MANUAL.DOC  -  PKZIP
  795.                            ARJ.DOC     -  ARJ
  796.                            LHA.DOC     -  LHA
  797.                            PAK.DOC     -  PAK
  798.                            ARCA.DOC    -  ARCA
  799.                            ARCE.DOC    -  ARCE
  800.  
  801.   With the exception of LHA, these files are distributed as named above.  The
  802.   LHA package usually contains LHAxxx.DOC, where xxx denotes a 3 digit version
  803.   number.  Simply renaming this file to LHA.DOC will suffice.
  804.  
  805.   11.4  Tagging Files
  806.  
  807.        Groups of files appearing in the active file list may be marked for
  808.   certain archiving operations by "tagging" them.  To tag a file, move the
  809.   cursor bar to the file and press the space bar or one of the plus (+) keys.
  810.   A right triangle symbol appears to the left of the file name to denote its
  811.   tagged status.  The tag is a toggle operation and therefore files are
  812.   untagged the same way they are tagged.  All files in an active window may be
  813.   tagged at once by pressing Ctrl+T and all tagged files may untagged at once
  814.   by pressing Ctrl+U.  The status of tagged files in both windows is
  815.   constantly displayed and updated on the main AM display.
  816.  
  817.        The mouse may also be used for tagging.  Groups of files may be tagged
  818.   by holding down the left mouse button and slowly dragging the mouse cursor
  819.   down the active file list.  Individual files may be tagged by pressing the
  820.   right mouse button.
  821.  
  822.        Files tagged in a directory will be added to the master tag list.  If
  823.   AM is configured to support global tagging, you may change to a different
  824.   directory in either window and tag more files.  In this way, you can tag
  825.   files from anywhere in your system.  If global file tagging is not
  826.   supported, the current tagged list is cleared any time the active window
  827.   experiences a change of directory.  Alt+U clears the global tag list.
  828.  
  829.  
  830.  
  831.  
  832.                                      - 13 -
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.        The current tagged file list can be viewed at any time by pressing
  840.   Alt+T.  The copy (Alt+C), move (Alt+C), delete (Del), and change attribute
  841.   (Ctrl+F3) commands will also invoke the tag list dialog if one or more files
  842.   are tagged when the command is issued.
  843.  
  844.        CAUTION:   The AM global tag list stores full DOS path names to each
  845.   tagged file.  The following example shows how you can be "tricked" by PKZIP.
  846.   Two files are tagged.  They have the same name but reside in different
  847.   directories, as in:
  848.  
  849.         C:\MYUTIL\WORDPROC.DAT
  850.         D:\WORD\PROJECT\NEW\WORDPROC.DAT
  851.  
  852.   If the PKZIP command option "Store Paths" switch ("-P") is not set, PKZIP
  853.   will NOT add the second file to a ZIP archive because it will ignore path
  854.   names and refuse to add duplicate file names.  So if you intend to tag files
  855.   of the same name from different directories, be SURE that the "Store Paths"
  856.   option is ON.
  857.  
  858.        You can use Ctrl+G and then Ctrl+K to mark a block of files.  Ctrl+G
  859.   marks the first file in the block and Ctrl+K marks the last file.  The first
  860.   file must be higher on the list than the last file.
  861.  
  862.        The mouse may also be used to tag files by selecting a file name,
  863.   holding down the left mouse button, and dragging the mouse up or down.  The
  864.   right mouse button will tag files individually.
  865.  
  866.   11.5  Dialog Boxes
  867.  
  868.        Dialog boxes are used extensively throughout AM to provide the user
  869.   with a means to set specific commands and options prior to performing a
  870.   particular operation.  Dialogs usually include boxed clusters of controls
  871.   called radio buttons and check boxes.  The user may move from cluster to
  872.   cluster with the Tab/Shift-Tab command, Alt+Shortcut, or mouse.  The
  873.   shortcut character is the highlighted character in the title string of the
  874.   cluster box.
  875.  
  876.        Dialog boxes also contain push-button controls that are labeled
  877.   according the command function they represent.  A push button may be
  878.   "pushed" by clicking with the mouse, pressing Alt+Shortcut key, or by moving
  879.   to the control and pressing the Enter key.
  880.  
  881.        Many dialogs contain editable text fields and some dialogs have input
  882.   fields that are updated dynamically as the user selects specific options or
  883.   switches.  Pressing the Enter key while in an editing field is the same as
  884.   pushing the Okay button for that dialog.  The oKay button always signals to
  885.   AM to proceed with the operation and the Quit button always exits the dialog
  886.   with no further action.
  887.  
  888.  
  889.  
  890.                                      - 14 -
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.        Some dialogs contain list boxes which contain a list of file names.  A
  898.   prime example is the compressed file contents viewer dialog.  If a dialog
  899.   box contains an input field for the entry of a file name or other text, the
  900.   box should be exited for continuation of the operation by pressing the Enter
  901.   key while the cursor is in the text field.  If the text field is empty when
  902.   the Enter key is pressed, the operation will be aborted.  Pressing Esc
  903.   anytime while in a dialog box will close the box and abort the operation.
  904.   Almost all dialog boxes have a push-button, which is a small box with an
  905.   "oKay" inside.  Mouse users may move the mouse to the "oKay" and press the
  906.   left mouse button to signify proceeding with the indicated operation.
  907.  
  908.   11.6  The Mouse Interface
  909.  
  910.        Mouse users will find the AM mouse interface quite easy and intuitive
  911.   to use.  Like most mouse interfaces, the mouse cursor may be moved to a
  912.   control location on the main display or within a dialog box and the left
  913.   mouse button clicked to activate that command or control.  For example,
  914.   moving the mouse cursor to the pull-down menu line at the top of the main
  915.   display and pressing the left mouse button will activate the menu system.
  916.        Each window and dialog box has a small square symbol between brackets
  917.   in the upper left corner of the frame.  Clicking on this symbol will close
  918.   the window just as if the Esc key were pressed.  Clicking on the "Quit"
  919.   button in any dialog will also close the window with no action.
  920.  
  921.        The mouse can be used with scroll bars that appear down the right edge
  922.   of any window that contains a file list.  You may "drag" the scroll marker
  923.   down the bar by moving the cursor to the marker, holding down the left
  924.   button, and moving the mouse up or down.  Alternatively, you may place the
  925.   cursor at a specific location on the vertical bar and click the mouse.  This
  926.   will move the file list cursor bar to the relative location of the scroll
  927.   bar marker.  Clicking on either arrow at the top and bottom of the scroll
  928.   bar scrolls the file list up and down, respectively.
  929.  
  930.        LIST users please note that AM does not pass the mouse command line
  931.   switch ("/M") to LIST.  If you desire to have the mouse active when entering
  932.   LIST from AM, you must use the LIST clone feature to create a version of
  933.   list that will use the mouse.  Please see LIST.DOC for further information.
  934.   This accommodates those users who wish to use a file browser other than
  935.   LIST.
  936.  
  937.        AM saves and restores the mouse state when shelling out to call an
  938.   external program.  This prevents AM from altering the target program's mouse
  939.   defaults.  AM also saves the mouse state at program run time and restores it
  940.   upon program exit.
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.                                      - 15 -
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.   11.7  Positioning Windows/Dialogs
  956.  
  957.        The editor and compressed file viewer windows may be moved around the
  958.   screen with the mouse or the keyboard.  Press the Ctrl+F5 key, move the
  959.   window to the desired location with the arrow keys, and then press the Enter
  960.   key to exit the move mode.  Or you may position the mouse on the top window
  961.   frame, hold down the left button, and drag the window to a new location.
  962.  
  963.        Edit windows may be re-sized.  Click on the lower right corner of the
  964.   edit window and drag the mouse until the desired window width and height are
  965.   reached.  Or press the F5 key and control the width and height with the
  966.   left/right or up/down arrow keys, respectively.
  967.  
  968.  
  969.   12  Keyboard Commands
  970.  
  971.  
  972.        In addition to comprehensive mouse support, AM employs the use of Ctrl,
  973.   Alt, and function key inputs.
  974.  
  975.   12.1  Function Keys
  976.  
  977.        Each of the ten keyboard function keys are assigned a command and
  978.   pressing one of these keys bypasses the menu system and immediately executes
  979.   the assigned command.  Function key command assignments are:
  980.  
  981.                  F1  -  Help
  982.                  F2  -  Change active archive system
  983.                  F3  -  Change system drive
  984.                  F4  -  Zoom active window
  985.                  F5  -  Open directory tree display
  986.                  F6  -  Rename file
  987.                  F7  -  Change file mask
  988.                  F8  -  Change file sort
  989.                  F9  -  Compress file(s)
  990.                  F10 -  Decompress file(s)
  991.  
  992.        The following function keys may be used as key "macros" while operating
  993.   in any of the compression dialogs:
  994.  
  995.                  F8  - Insert file name under active cursor bar
  996.                  F9  - Insert current date string (mm-dd-yy)
  997.                  F10 - Insert current directory name
  998.  
  999.   12.2  Alt+Key Commands
  1000.  
  1001.        Seven Alt+key commands are dedicated to activating one of the pull-down
  1002.   menus.  The are:
  1003.  
  1004.  
  1005.  
  1006.                                      - 16 -
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.                  Alt+A  -  Archive commands
  1014.                  Alt+F  -  File commands
  1015.                  Alt+N  -  Navigation commands
  1016.                  Alt+I  -  Miscellaneous commands
  1017.                  Alt+P  -  Executable program menu
  1018.                  Alt+G  -  Tag operations menu
  1019.                  Alt+H  -  Help menu
  1020.  
  1021.        The following Alt+key commands are assigned to the indicated AM
  1022.   functions:
  1023.  
  1024.                  Alt+C  -  Copy file(s)
  1025.                  Alt+D  -  Tag By Date
  1026.                  Alt+E  -  Edit file
  1027.                  Alt+J  -  Compress directory
  1028.                  Alt+K  -  Calculator
  1029.                  Alt+L  -  Calendar
  1030.                  Alt+M  -  Move file(s)
  1031.                  Alt+Q  -  Toggle video mode
  1032.                  Alt+R  -  Register ArcMaster
  1033.                  Alt+S  -  Search for file
  1034.                  Alt+T  -  Show tagged files
  1035.                  Alt+U  -  Untag files - global
  1036.                  Alt+V  -  Call virus scanner
  1037.                  Alt+W  -  Make both windows same
  1038.                  Alt+X  -  Exit immediately to DOS
  1039.                  Alt+Z  -  Check for duplicate files
  1040.                  Alt+F1 -  Load AM.DOC into the viewer
  1041.                  Alt+F4 -  Call 4DOS DESCRIPT.ION Editor
  1042.                  Alt+F3 -  Check disk functions
  1043.                  Alt+F10-  Convert compressed file(s)
  1044.                  Alt+=  -  Exit to active directory
  1045.  
  1046.   12.3  Ctrl+Key Commands
  1047.  
  1048.        The following Ctrl+key commands are assigned to the indicated AM
  1049.   functions:
  1050.  
  1051.                  Ctrl+A  -  Auto-update function
  1052.                  Ctrl+B  -  Reset file archive bits
  1053.                  Ctrl+C  -  Configure ArcMaster
  1054.                  Ctrl+D  -  Update To Latest
  1055.                  Ctrl+E  -  Edit new file
  1056.                  Ctrl+F  -  Call FormatMaster (FM.EXE)
  1057.                  Ctrl+G  -  Start tag block
  1058.                  Ctrl+I  -  Edit with internal editor
  1059.                  Ctrl+K  -  Tag from tag block start
  1060.                  Ctrl+L  -  Pack EXE file function
  1061.  
  1062.  
  1063.  
  1064.                                      - 17 -
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.                  Ctrl+N  -  Browse with internal browser
  1072.                  Ctrl+P  -  Print file/directory listing
  1073.                  Ctrl+Q  -  Quick directory tree
  1074.                  Ctrl+S  -  Single Archive function
  1075.                  Ctrl+T  -  Tag all files
  1076.                  Ctrl+U  -  Untag all files
  1077.                  Ctrl+V  -  VirusSCAN DOS files
  1078.                  Ctrl+W  -  Swap main file windows
  1079.                  Ctrl+X  -  Program Exec Menu
  1080.                  Ctrl+Z  -  Call PKZIPFIX
  1081.                  Ctrl+F1 -  Help for command keys
  1082.                  Ctrl+F2 -  Print text file
  1083.                  Ctrl+F3 -  Change file attribute
  1084.                  Ctrl+F4 -  Call 4DOS DESCRIBE
  1085.                  Ctrl+F5 -  Move window/dialog
  1086.                  Ctrl+F6 -  Set tagged files date/time stamp
  1087.                  Ctrl+F7 -  Set mask like extension
  1088.                  Ctrl+F8 -  Tag all like extension
  1089.                  Ctrl+F9 -  Multi-update function
  1090.                  Ctrl+Enter  -  Execute EXE file
  1091.                  Ctrl+PgUp - Go to parent directory
  1092.  
  1093.   12.4  Other Commands
  1094.  
  1095.        The PgUp, PgDn, Up/Down Arrow, Home, and End keys are all operative for
  1096.   moving through any of the file list displays.  Other miscellaneous commands
  1097.   are:
  1098.  
  1099.             Asterisk    -  Reset the file mask to *.* and refresh
  1100.             Slash       -  Access menu system
  1101.             Ins Key     -  Set Archive "Hot Name"
  1102.             Del Key     -  Delete single or tagged files
  1103.             Space Bar   -  Tag/Untag file
  1104.  
  1105.        The archive "Hot Name" command will set the hot name to the file name
  1106.   under the cursor bar.  Any time thereafter that you elect to compress files,
  1107.   AM will insert that name automatically into the archive name field in the
  1108.   appropriate dialog box.  The Ins Key is a toggle so if the hot name is not
  1109.   set when pressed, it will be set and if it is set, it will be cleared.
  1110.  
  1111.  
  1112.   13  Configuring ArcMaster
  1113.  
  1114.  
  1115.        AM provides the capability to configure various options and to save
  1116.   those options to a disk file if desired.  Selection of the Configure AM item
  1117.   on the mIsc pull-down menu (Alt+I) or pressing Ctrl+C opens a dialog box in
  1118.   which the configuration may be set.  Keep in mind that the current sort
  1119.  
  1120.  
  1121.  
  1122.                                      - 18 -
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.   order, active archive system, active convert option, and all archive system
  1130.   command options will also be saved in their current states.
  1131.  
  1132.        If you exit the configuration dialog via the "oKay" button, the changes
  1133.   you made will be in effect immediately but will not be saved to disk.  You
  1134.   must use the "Save" button (Alt+S) to save the configuration to the file
  1135.   named AM.CFG.
  1136.  
  1137.        You may use the "Reset" button to negate any changes you have made and
  1138.   restore all settings to the state they were in upon entry to the dialog.
  1139.  
  1140.        The "Load" button can be used to load a configuration that you have
  1141.   stored in a directory other than the AM host directory.
  1142.  
  1143.        Help can be attained for any specific configuration item/field by
  1144.   pressing the F1 key.  The help text that appears will be specific to the
  1145.   focused item/field when the F1 key is pressed.
  1146.  
  1147.   13.1  Options
  1148.  
  1149.        There is a check box cluster which can be used to toggle various AM
  1150.   options as listed below:
  1151.  
  1152.        Options
  1153.        [X] Show hidden files         - Display hidden/sys/r-only files
  1154.        [ ] Force 43/50 line mode     - Force 43/50 line EGA/VGA mode
  1155.        [X] Beeps on                  - Turn sound on/off
  1156.        [ ] Use password              - Use password for compression ops
  1157.        [X] Prompt for overwrite      - Confirm before overwrite during copy
  1158.        [X] Pause after ops           - After comp/decomp/etc.
  1159.        [X] Sort directory tree       - Sort the directory tree
  1160.        [X] Sort archive by extn      - Sort by extension in archive viewer
  1161.        [X] Pause after prog exec     - Pause after executing program
  1162.        [ ] Erase after conversion    - Erase target files after conversion
  1163.        [ ] Menu acts on 1st click    - First mouse click activates menu item
  1164.        [ ] Use global tagging        - Permit tagging from multiple dirs
  1165.        [ ] Use 24 hour time          - Display time in 24 hour "hh:mm" format
  1166.        [X] Use shadowed windows      - All windows/boxes are shadowed
  1167.  
  1168.        Most of these options are self-explanatory.  The "Mouse 1st Click"
  1169.   option affects how the left mouse button works in the AM menu system.  If
  1170.   turned OFF (unchecked is the default), then AM will move the cursor bar to
  1171.   an item on the first click and then will select the item on the second
  1172.   click.  This provides a bit of protection against selecting the wrong item.
  1173.   If "Mouse 1st Click" is ON then AM will immediately select the menu item
  1174.   under the mouse cursor when the left button is clicked.
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.                                      - 19 -
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.        "When Sort Arc by Ext" is checked, AM will sort the contents of a
  1188.   compressed file by file name and extension so that files with common
  1189.   extensions are grouped together.
  1190.  
  1191.        If the "Pause After Exec" option is selected then AM will pause
  1192.   immediately after the target program is exited so you can see any program
  1193.   results on the screen.
  1194.  
  1195.   13.2  Anti-virus Scanner
  1196.  
  1197.        Either the McAfee VIRUScan or Norton Anti-virus program may be
  1198.   selected.  Be sure that the correct file name and path for the selected
  1199.   scanner is placed into the "Vscan:" field.
  1200.  
  1201.   13.3  Start-up Directories
  1202.  
  1203.        A directory path name may be entered for each of the two file windows
  1204.   for AM to use upon start-up.  Each time AM is started, these directory paths
  1205.   will be used unless overridden by a command line entry.  Do not enter a file
  1206.   mask here.  AM will save the file mask active for each window when the
  1207.   configuration is saved and will used the saved file masks automatically at
  1208.   start-up.  You may also enter the name of a compressed file on the command
  1209.   line to direct AM to go immediately into the compressed file viewer using
  1210.   the file name as the target.
  1211.  
  1212.   13.4  The ArcMaster Work Directory
  1213.  
  1214.        This is an extremely important configuration item.  AM requires
  1215.   exclusive use of a hard drive directory for use during archive file
  1216.   conversions and other file operations.  AM will also use this directory as a
  1217.   temporary directory for archiving programs use.
  1218.  
  1219.        PKZIP fans should note that there are two instances where PKZIP may
  1220.   need to create a temporary file on a hard drive while manipulating a ZIP
  1221.   file on a floppy drive.  The first is when PKZIP is building a large file on
  1222.   a floppy disk and the second case is when PKZIP is modifying an existing ZIP
  1223.   file on a floppy disk.  The first case must be handled by placing the
  1224.   following line in your AUTOEXEC.BAT file:  SET PKTMP=X:\TEMPPATH, where
  1225.   X:\TEMPPATH is the full path name of the temporary directory you wish PKZIP
  1226.   to use.  PKZIP does NOT use the "-b" switch in this case.  The second case
  1227.   is handled by designating X:\TEMPPATH as the AM temporary directory as
  1228.   described above.  It is recommended, but not required that the same
  1229.   directory be used for both cases.
  1230.  
  1231.   13.5  The Log Directory
  1232.  
  1233.        AM provides a graphical directory tree for navigation and directory
  1234.   manipulation.  If no Log directory is specified, AM will always scan the
  1235.  
  1236.  
  1237.  
  1238.                                      - 20 -
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.   current drive whenever the tree needs to be displayed.  This can be a
  1246.   lengthy process, especially on slow hard drives with lots of directories.
  1247.   AM uses a directory log file strategy to avoid this problem.  What this
  1248.   means is that if a valid Log directory is specified, the first time the tree
  1249.   is scanned on a given drive AM will store the tree information in a file and
  1250.   place it in the specified log directory.  Then all following calls to access
  1251.   the tree result in AM reading that file instead of re-scanning the drive,
  1252.   which is very fast.  The file names that AM will place in the Log directory
  1253.   are NEW-WARE.X, where X is the drive designator.
  1254.  
  1255.        One important item must be kept in mind when using this strategy.  AM
  1256.   will have no knowledge of any directories that are created, renamed, or
  1257.   removed outside of AM.  You can accomplish each of these operations while in
  1258.   the tree.  If you add a new directory and then bring up AM and call up the
  1259.   tree, the new directory will not appear on the tree.  In this case you will
  1260.   need to manually re-scan the disk by invoking the AM directory dialog with
  1261.   F3 or F5 and pressing the "Scan Drv" button.
  1262.  
  1263.        Just remember that if you have not entered a valid DOS drive:\directory
  1264.   path in the log directory field of the configuration dialog, AM will scan
  1265.   the disk to collect the directory names each time the tree is opened.
  1266.  
  1267.        This version of AM includes an alternative to the main AM directory
  1268.   tree.  Use Ctrl+Q to activate the Quick Tree function.  This function
  1269.   displays an abbreviated directory tree that does not use the log file
  1270.   strategy described above.
  1271.  
  1272.        AM provides special support for CD-ROM drives.  When a CD-ROM drive is
  1273.   accessed the first time, AM will scan the drive to build the directory tree.
  1274.   This data will then be stored in a file with a name built from the first 8
  1275.   characters of the CD-ROM disk volume label and an extension of "CDR".  If no
  1276.   volume label exists, AM will name the file "CD-ROM" plus the drive letter.
  1277.   For example, if you access a CD-ROM drive with a disk whose volume label is
  1278.   "ATLAS", the log file name will be "ATLAS.CDR" and if you access a CD-ROM
  1279.   drive that is drive "M" in your system that has a disk that does not have a
  1280.   volume label, the log file name will be "CD-ROM.M".
  1281.  
  1282.   13.6  The Compression Program Directory
  1283.  
  1284.        This directory is where AM will expect to find ALL of the supported
  1285.   archive system programs:
  1286.  
  1287.             ARJ.EXE
  1288.             ARCE.COM
  1289.             LHA.EXE
  1290.             PAK.EXE
  1291.             PKZIP.EXE
  1292.             PKZIPFIX.EXE
  1293.  
  1294.  
  1295.  
  1296.                                      - 21 -
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.             PKUNZIP.EXE
  1304.             ZIP2EXE.EXE
  1305.  
  1306.        If no valid directory is entered here, AM will expect the programs
  1307.   above to reside in a directory identified in the DOS path.  In addition, AM
  1308.   expects to find the archive system program documentation files in this
  1309.   directory.  The configuration field name is "CompDir:"  AM will also look
  1310.   for the respective archive system .DOC files in this directory.
  1311.  
  1312.   13.7  Password Operations
  1313.  
  1314.        ARJ, PAK, and ZIP each have a provision for password protecting
  1315.   compressed files.  To enable password use, first invoke the AM configuration
  1316.   dialog (Ctrl+C) and then check the box that is labeled "Use Password".  If
  1317.   this box is checked, a password entry field will appear in the compression
  1318.   dialog when compressing files.  If this field is left blank, AM will not
  1319.   pass the password switch to the active archive system program.  If it is not
  1320.   blank, whatever appears in this field will be passed as the password.
  1321.  
  1322.        You may save your password to the AMCONFIG.CFG file by invoking any
  1323.   archive system compression dialog, entering a password in the password field
  1324.   and then saving the configuration.  If you have AM configured to use a
  1325.   password and have a password saved in the .CFG file, you can still compress
  1326.   a batch of files not using the password by simply clearing the password
  1327.   field and leaving it that way throughout the session.
  1328.  
  1329.   13.8  Editor, Browser, and Scan Names
  1330.  
  1331.        Each of these fields identify to AM the executable file names to call
  1332.   when editing, browsing, or scanning.  Be sure to enter the file name as a
  1333.   minimum.  The full path is optional, but if no path is included with the
  1334.   file name, AM will expect DOS to find the program on the DOS path.  Here is
  1335.   are some examples of how the browser might be identified:
  1336.  
  1337.        C:\UTIL\LIST.COM
  1338.        LIST
  1339.        LIST.COM
  1340.        E:\MYUTIL\VIEWER\LIST.COM
  1341.  
  1342.        AM also supports the Norton Anti-Virus (NAV) program.  To use NAV,
  1343.   insure that the selected scanner program and the "Vscan:" field match.
  1344.  
  1345.   13.9  Setting Editor Memory
  1346.  
  1347.        The "Edit Mem:" field controls the amount of memory AM will allocate to
  1348.   the internal text editing system at start-up.  This value must fall between
  1349.   1024 and 163,840 bytes.  The maximum size text file that may be edited is
  1350.   64,535 bytes.
  1351.  
  1352.  
  1353.  
  1354.                                      - 22 -
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.        AM will allocate the amount of memory designated in the "Edit Mem:"
  1362.   field at program start-up.  This pool of memory is used by each editor that
  1363.   is activated and by the clipboard, which is used for cut and paste
  1364.   operations.  Suppose you have configured AM for 16,384 bytes.  Then you load
  1365.   an 8,433 byte file into one editor and a 5,361 byte file into another
  1366.   editor.  That leaves 3073 bytes for cutting and pasting blocks from one
  1367.   editor to another.  If insufficient memory exists to support loading a text
  1368.   file into an editor, AM will inform you and abort the operation.
  1369.  
  1370.  
  1371.   14  Viewing Archive File Contents
  1372.  
  1373.  
  1374.        The contents of any of the supported archive file types, including
  1375.   self-extracting EXE files (SXF), may be viewed by moving the active window
  1376.   cursor bar to the file and pressing the Enter Key.  A window will open that
  1377.   displays a sorted list of the files contained in the target file.  This
  1378.   window operates very much like the active window in that you move through
  1379.   the file list with keypad cursor keys or with the mouse and scroll bar
  1380.   except that it is a dialog and has push button controls.
  1381.  
  1382.        The number that appears in the upper right hand area of the dialog
  1383.   frame represents a rough estimate of the size of a resultant compressed file
  1384.   and is based upon the number of bytes tagged at that time.
  1385.  
  1386.        Files may be tagged for decompression operations in the same manner
  1387.   that files are tagged on the main file list.  Pressing the "UnXXX" button,
  1388.   where XXX is ZIP, ARJ, etc., proceeds with decompression.
  1389.  
  1390.        A special symbol is used to mark the end of a line that represents a
  1391.   file that PKZIP has marked as a text file.
  1392.  
  1393.        File lines that represent compressed files with the file attribute set
  1394.   to other than normal will be in a different color.
  1395.  
  1396.   14.1  Multiple Compressed File Viewers
  1397.  
  1398.        Two compressed file viewing dialog windows may be active at one time
  1399.   and it is possible to copy files from one compressed file to another.  The
  1400.   following sequence demonstrates how to accomplish this:
  1401.  
  1402.        1. In either main file window, move the cursor bar to a compressed
  1403.           file and press Enter to activate a viewer.
  1404.        2. Click on either main window with the mouse or press Alt+1 or Alt+2
  1405.           to go back to a main file window.
  1406.        3. Move the cursor bar to a different compressed file and press the
  1407.           Enter key to activate a second viewer.
  1408.        4. Tag files in one of the viewers and press the Copy button.  The
  1409.  
  1410.  
  1411.  
  1412.                                      - 23 -
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.           tagged files will be copied to the inactive viewer.
  1420.  
  1421.   You can move from viewer to viewer with the mouse or the Alt+Number key
  1422.   where Number is the viewer number.
  1423.  
  1424.   14.2  Browsing a Compressed File
  1425.  
  1426.        Compressed files may be viewed with the designated file browser by
  1427.   moving the cursor bar to the desired file and pressing Enter.  The file will
  1428.   be decompressed by AM to the work directory and browsed.  When browsing is
  1429.   complete, AM deletes the file.  A compressed file inside another compressed
  1430.   file will may also be viewed.
  1431.  
  1432.   14.3  Editing A Compressed File
  1433.  
  1434.        A compressed text file may be edited with the user-defined external
  1435.   editor or with the internal AM editor.  In both cases the file is extracted
  1436.   to the AM work directory and edited.  After the edited file is saved, it
  1437.   replaces the original inside the compressed file before being deleted.  The
  1438.   dialog Edit button calls the external editor.  To use the AM editor, press
  1439.   Ctrl+I with the cursor bar over the target file.
  1440.  
  1441.   14.4  Creating/Editing a ZIP File Comment
  1442.  
  1443.        The PKWare ZIP system allows the addition of a comment to each ZIP
  1444.   file.  AM provides a means to create and/or edit this comment with the Cmnt
  1445.   button.  Press this button to bring up the comment editor.  If a comment
  1446.   exists, it will be loaded into the editor.  If not, you may create a new
  1447.   comment and save it from the editor.
  1448.  
  1449.  
  1450.   15  ARJ Considerations
  1451.  
  1452.  
  1453.        ARJ was the first file compression system to offer a backup mode that
  1454.   permits spanning of a diskette by a compressed file and New-Ware feels that
  1455.   the ARJ backup system is superior to that of the PKWare System.  You can use
  1456.   AM to view the contents of an ARJ backup volume and you can even extract
  1457.   individual files quickly and easily.  Just be aware that the first and last
  1458.   files in an ARJ backup volume may be split across two diskettes and that you
  1459.   should NOT attempt to view or edit these files.  You can use the AM file
  1460.   list sort toggle to list the contents as they are stored in the ARJ file to
  1461.   determine which are the first and last files in the volume.
  1462.  
  1463.        One other note regarding the ARJ backup system.  You can create backup
  1464.   volumes on a hard disk and then check the overall integrity of each volume
  1465.   before transferring them to diskettes.  You can do this by using the ARJ
  1466.  
  1467.  
  1468.  
  1469.  
  1470.                                      - 24 -
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.   volume size parameter ("Vol Size:" in AM) and the multi-volume ("-v")
  1478.   switch.  Consult ARJ.DOC for details.
  1479.  
  1480.        Note that ARJ does not place inane restrictions on the size of the list
  1481.   file it will process.
  1482.  
  1483.  
  1484.   16  PKZIP Considerations
  1485.  
  1486.  
  1487.        PKZIP release 2.04c and later create some special problems that the ZIP
  1488.   fan should be aware of when using AM.
  1489.  
  1490.   16.1  PKZIP List File Problems
  1491.  
  1492.        New-Ware uses the PKZIP list file capability to pass file name lists
  1493.   for compression.  This avoids the severe DOS command line length restriction
  1494.   but involves some PKZIP restrictions.  The list file that AM passes to PKZIP
  1495.   contains the full DOS path name of each tagged file.  Obviously, the longer
  1496.   the path name, the longer each list file line will be and the larger the
  1497.   list file will be.
  1498.  
  1499.        Experimentation has shown that PKZIP will refuse to accept any list
  1500.   file of this type that is larger than 3700 bytes.  If the list file is
  1501.   greater than 3700 bytes, PKZIP prints a "Insufficient memory" message and
  1502.   quits.  This will happen regardless of the actual amount of EMS/XMX memory
  1503.   actually available!  PKZIP just blindly quits!
  1504.  
  1505.        To circumvent this inane restriction, AM monitors the size of the list
  1506.   file as it is being built and when the 3700 byte limit is reached, AM calls
  1507.   PKZIP to process the file.  Then AM continues with a new list file until the
  1508.   tagged file queue is exhausted or limit is reached again.  This works
  1509.   wonderfully well in all but one important situation.  It will NOT work with
  1510.   the PKZIP backup mode!  This is because PKZIP will just start fresh when
  1511.   called on successive occasions.  It is strongly recommended that you use the
  1512.   AM compress directory function (Alt+J) in conjunction with the backup mode
  1513.   instead of tagging a large number of files for backup.
  1514.  
  1515.   16.2  PKZIP Backup Files
  1516.  
  1517.        Another PKZIP situation to be aware of is that ZIP files that have been
  1518.   created on multiple diskettes by using the PKZIP backup mode cannot all be
  1519.   read by the AM compressed file viewer.  PKZIP stores the beginning of its
  1520.   central directory for the entire backup set on the one of the last
  1521.   diskettes.  Other disks contain ZIP files that have no central directory and
  1522.   AM will not read these ZIP files.  In fact, PKZIP will not give you a
  1523.   listing of such a file and instead will print an error message telling you
  1524.   to use PKZIPFIX on the file!
  1525.  
  1526.  
  1527.  
  1528.                                      - 25 -
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.        When AM reads the ZIP file from a diskette that contains the central
  1536.   directory record for the backup set, the disk number of the diskette that
  1537.   contains the ZIP file that actually includes the compressed file data is
  1538.   listed to the right of the file data line in the viewer.  If the files are
  1539.   not grouped by disk number, use the toggle sort (F3) function to list the
  1540.   files in unsorted order.
  1541.  
  1542.        And one last note.  If you should happen to lose or damage the one of
  1543.   the diskettes that contains the central directory in a ZIP backup set, you
  1544.   can use PKZIP fix to restore the central directory of any ZIP file residing
  1545.   on any single diskette in the set, but the integrity of the entire set is
  1546.   lost.
  1547.  
  1548.  
  1549.   17  The AM Internal Editor
  1550.  
  1551.  
  1552.        AM has a simple yet powerful internal editing system that not only
  1553.   supports text file editing but supports cut and paste operations between two
  1554.   text files as well.  The AM internal editor is called when Ctrl+I is pressed
  1555.   or when Alt+E is pressed and there is no external editor defined.
  1556.  
  1557.        The amount of memory available for the internal editing buffers is
  1558.   dependent upon the "Edit Mem:" field in the AM configuration dialog.
  1559.  
  1560.        Editor commands are based upon the well-known WordStar command set.
  1561.   Consult the on-line help system for editing command key assignments.  Note
  1562.   that the bottom status line contains main editing commands whenever an
  1563.   editor is active.
  1564.  
  1565.        Here is an example of how to use multiple editor windows:
  1566.  
  1567.        1. Move the active file list cursor bar to a text file and press
  1568.           Ctrl+I.  An edit window loaded with the file contents will appear.
  1569.        2. Activate one of the two main file list windows by pressing Ctrl+1
  1570.           or Ctrl+2 or by clicking with the mouse.
  1571.        3. Move the cursor bar to a different text file and press Ctrl+I.
  1572.        4. Two edit windows are not active.  You can select either window by
  1573.           clicking with the mouse or using the Alt key plus the window
  1574.           number.
  1575.        5. Cut & paste and clipboard commands are visible on the bottom status
  1576.           line and explained in the on-line help file.
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                                      - 26 -
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.   18  AM Use of Expanded/Extended Memory
  1594.  
  1595.  
  1596.        The AM overlay file, AM.OVR, automatically uses expanded memory (EMS)
  1597.   if a memory manager loaded and sufficient EMS memory can be allocated.
  1598.   Loading AM under Windows 3.0 might fail if the NOEMS switch is used with the
  1599.   memory manager.  This will occur when using EMS386 but not when using QEMM
  1600.   6.x.
  1601.  
  1602.        When AM "shells out" to DOS to perform some function like calling PKZIP
  1603.   to ZIP a group of files, AM will check available memory and will swap the
  1604.   entire DOS memory space out to EMS/XMS memory or a disk file.  If you have
  1605.   an EMS memory manager loaded and sufficient memory can be allocated, AM will
  1606.   swap to expanded memory.  If you have no EMS but do have an extended (XMS)
  1607.   memory driver loaded, AM will use XMS memory if sufficient memory is
  1608.   available.  If no EMS or XMS memory is available, AM will swap out to a disk
  1609.   file.  Obviously, the swap to EMS/XMS is so fast as to be transparent
  1610.   whereas the swap to disk will cause a noticeable delay.
  1611.  
  1612.  
  1613.   19  Running AM with NDOS or 4DOS
  1614.  
  1615.  
  1616.        AM has been tested while running under the Norton Utilities NDOS from
  1617.   Symantec Corp.  NDOS is quite similar to 4DOS and in fact both programs are
  1618.   the work of Tom Rawson.  When AM shells out out to view the contents of a
  1619.   compressed file, the command passed to DOS is a call for LIST, which is
  1620.   intended to call Vern Buerg's LIST.COM.  LIST, however, is an internal
  1621.   command of NDOS and 4DOS.  The internal LIST command will work fine with AM
  1622.   version 6.5 and later, but if you desire to use the more powerful LIST.COM
  1623.   there are three ways to do so.
  1624.  
  1625.        The first way is to disable the internal LIST command by issuing the
  1626.   command SETDOS /I-LIST from the AUTOEXEC.BAT (or NSTART.BAT) file.  The
  1627.   second way is to issue the command ALIAS LIST C:\UTIL\LIST.COM.  This also
  1628.   disables the internal LIST command, but you can use the alias command to use
  1629.   the internal LIST function under a different name, as in the command ALIAS
  1630.   SHOW *LIST.  The third way is to rename LIST.COM and to configure AM to call
  1631.   the renamed version of LIST.
  1632.  
  1633.        AM also provides extensive support for the 4DOS/NDOS DESCRIPT.ION
  1634.   files.  Ctrl+F4 invokes the 4DOS/NDOS DESCRIBE command with the name of the
  1635.   file under the active cursor bar.  The Alt+F4 command calls the editor
  1636.   defined in the AM configuration "4Dos Ed:" field.  You may place a command
  1637.   line parameter list following the file name entry, if so desired.  If no
  1638.   program is designated in the "4Dos Ed:" field, AM will use the internal
  1639.   editor.  AM will update DESCRIPT.ION files in the source and destination
  1640.   directories during any rename, copy, move, delete, and archive convert
  1641.  
  1642.  
  1643.  
  1644.                                      - 27 -
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.   operations.  This includes using the move option with any of supported file
  1652.   compressors.
  1653.  
  1654.        4DOS is Copyright by JP Software.  NDOS is a version of 4DOS licensed
  1655.   to the Symantic Corp.
  1656.  
  1657.  
  1658.   20  Search Menu (Alt+S)
  1659.  
  1660.  
  1661.        AM provides a fast search for DOS or compressed files on the drive in
  1662.   the active window.  If searching for a DOS file and the target file name is
  1663.   found (wild cards are okay), AM will issue a notification prompt.  You have
  1664.   the choice of halting the search, continuing the search, or viewing the file
  1665.   list of the directory in which the file was found.  If you elect to view, AM
  1666.   will change to that directory and position the cursor bar over the target
  1667.   file name.
  1668.  
  1669.        Searching for a file inside an archive file operates in the same way
  1670.   except that AM will go through each directory on the current drive and open
  1671.   each archive file found and search it for the target file.  If found and you
  1672.   elect to view, AM will open the archive directory view window and position
  1673.   the cursor bar over the target file name.  You may elect to extract, erase,
  1674.   etc. tagged files in this case but please note that when the operation is
  1675.   complete that the active directory will have changed to the directory in
  1676.   which the target archive file was found.
  1677.  
  1678.  
  1679.   21  Program Menu (Ctrl+X)
  1680.  
  1681.  
  1682.        This command invokes the special AM user created program menu.  Please
  1683.   read the information in the file named PROGMENU.DOC.
  1684.  
  1685.  
  1686.   22  Registering AM (Alt+R)
  1687.  
  1688.  
  1689.        The command will open a window that will prompt you for the vital
  1690.   information needed to print the registration form.  You can close the window
  1691.   with no action at any time by pressing the Esc Key.  When all the
  1692.   information has been entered, you will have the opportunity to print the
  1693.   form on your printer.
  1694.  
  1695.   Copyright 1987,1993, all rights reserved.
  1696.   New-Ware
  1697.   8020 Camino Kiosco
  1698.   San Diego, CA 92122
  1699.  
  1700.  
  1701.  
  1702.                                      - 28 -
  1703.  
  1704.